/************************************************************************/
/*                     Copyright declaration                            */
/*                         (3-clause-BSD)                               */
/************************************************************************/

/*
* Copyright (c) 2009, Roc King
* All rights reserved.
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
*     * Redistributions of source code must retain the above copyright
*       notice, this list of conditions and the following disclaimer.
*     * Redistributions in binary form must reproduce the above copyright
*       notice, this list of conditions and the following disclaimer in the
*       documentation and/or other materials provided with the distribution.
*     * Neither the name of the OwnWaterloo,Roc King nor the
*       names of its contributors may be used to endorse or promote products
*       derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/

#ifndef CCURRY_TESTING_UTILITY_H
#define CCURRY_TESTING_UTILITY_H

#include <stddef.h>

#ifdef __cplusplus
extern "C" {
#endif /* #ifdef __cplusplus */

typedef enum privilege_mask {
    privilege_none      = 0x0,
    privilege_read      = 0x1,
    privilege_write     = 0x2,
    privilege_execute   = 0x4,
} privilege_mask;

int privilege_from_name(const char* name);
int privilege_from_attribute(char* attribute,const char* spliters);
const char* privilege_to_name(int privilege);

typedef struct storage_t storage_t;
const storage_t* storage_get(const char* storage_category);
void* storage_allocate(const storage_t* storage
                      ,size_t size,void* stack_duumy,int privilege);
void  storage_deallocate(const storage_t* storage,const void* address);

typedef struct promotion_t promotion_t;
const promotion_t* promotion_get(const char* promotion);
int promotion_promote(const promotion_t* promotion
                     ,const void* address,size_t length,int privilege);

#ifdef __cplusplus
};
#endif /* #ifdef __cplusplus */

#endif  /* include guard */
